POV-Ray : Newsgroups : povray.documentation.inbuilt : Documentation Review? : Re: Documentation Review? Server Time
28 Apr 2024 14:07:46 EDT (-0400)
  Re: Documentation Review?  
From: ingo
Date: 17 Mar 2009 17:15:59
Message: <Xns9BD1E27EE8C31seed7@news.povray.org>
in news:49bcf49b@news.povray.org Jim Holsenback wrote:

> "Jim Holsenback" <jho### [at] hotmailcom> wrote in message
> news:49b7d4d3@news.povray.org...
>[...] 
> from:
> 
> sphere {
>   .....
>   .....
> }
> 
> to:
> 
> sphere
> {
>   .....
>   .....
> }
> 
> Am I picking nits to be pointing this out?
> 

MMmmm yes and no. I tried to present a uniform style of coding in the 
docs but didn't really succeed. In a discussion on the matter Warp once 
pointed out that users/newbies should see different coding styles in 
the docs as they will also encounter them in the wild.

There is no 'standard' coding style for POV-Ray, so in that regard Warp 
is right, yet IMO the style in the docs should be consistent (as 
consistent as possible). Maybe add a chapter on style showing the 
differences, but .... beware, before you know the phrase "bain dead" 
will be used in discussions on the matter of the "right" coding style.


ingo (who still hasn't looked at your efforts on the wiki and is 
ashamed)


Post a reply to this message

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.